home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / commo51.arc / UPGRADE.DOC < prev    next >
Text File  |  1991-12-22  |  5KB  |  134 lines
  1.  
  2.                      {COMMO} 4.xx to 5.xx Upgrade Guide
  3.                      ----------------------------------
  4.  
  5.  
  6. Upgrading is very easy if you follow the instructions below.  These changes
  7. will bring you up to date.  Then you will probably want to take advantage of
  8. the new features to greatly increase the power of your macros.
  9.  
  10.  
  11. Configuration File
  12. ------------------
  13.  
  14. COMMO.CFG has been replaced with COMMO.SET.  All items in this new file are
  15. "keyworded."  This means that in the future you will only have to add an item
  16. or two to become current.  You won't have to redo the entire file any more.
  17.  
  18. The easiest way to upgrade to the new Setup File is to print out your
  19. Configuration File.  Then start {COMMO} 5.xx and press Alt-G to edit the Setup
  20. File.  Change any items as needed, then exit and restart {COMMO} (the Setup
  21. File is processed only at startup now).
  22.  
  23.  
  24. Dialing Directory
  25. -----------------
  26.  
  27. You will only need to change your Dialing Directory if you have used any
  28. alternate Dialing Prefixes -- #1, #2, #3 or #4.
  29.  
  30. The Dialing Prefix items in the Configuration File are gone, but you may now
  31. establish String Variables to have as many prefixes (or suffixes) as desired.
  32. For example, suppose you had this in 4.xx:
  33.  
  34.         23 * {AT U1 DT}        Dial Prefix #2
  35.  
  36. and you had a Dialing Directory entry:
  37.  
  38.         Joes-BBS        {#2 555-1234} {pword} ...
  39.  
  40. In 5.xx you would put the following in your Setup File:
  41.  
  42.         {set prefix2,AT U1 DT}   Alternate prefix
  43.  
  44. You could use a variable name of your choice instead of "prefix2."
  45.  
  46. Finally, in your Dialing Directory change the entry to:
  47.  
  48.         Joes-BBS        {%prefix2% 555-1234} {pword} ...
  49.  
  50.  
  51. Macro File
  52. ----------
  53.  
  54. Macro labels (they used to be called macro-id's) must now begin with a colon
  55. (:).  They may also be made up of one or more characters, of which the first
  56. eight are significant.
  57.  
  58. So just change all your macro labels from {abc} to {:abc}, etc., for now.
  59.  
  60. The password must now be specified with the built-in variable "_pas".  So just
  61. replace all occurrences of "#" with "%_pas".
  62.  
  63. The EXECute "%" parameters have all been replaced with String Variables or
  64. with Function Switches.  Here is a list of parameters and what to change them
  65. to:
  66.  
  67.  Old Parameter   Change to
  68.  -------------   ---------
  69.  
  70.         %a      Use "A" switch:  EXEC-A ...
  71.         %w      Use "W" switch:  EXEC-W ...
  72.         %p      %_port   (or %_por)
  73.         %s      %_speed  (or %_spe)
  74.         %m      %_modem  (or %_mod)
  75.         %c      %_cap
  76.         %u      String variable, "%uldir" for example.
  77.         %d      String variable, "%dldir" for example.
  78.         %k      Control character, e.g. change "%k^L" to just "^L".
  79.         %i      Use INPUt function prior to EXEC.  See example
  80.                 below.
  81.  
  82. EXED and EXEN are no longer valid functions and must be specified with
  83. Function Switches.  Change EXED to EXEC-D and EXEN to EXEC-N.
  84.  
  85. Note that Function Switches may be used in any combination.  Here is an
  86. example of a macro to upload a file using Zmodem with DSZ:
  87.  
  88.  ZMODEM batch   {:af2} {setv file,%uldir\}
  89.                 {input file,Enter a filename to UPLOAD}
  90.                 {exec-AWD c:\proto\DSZ.com port %_port sz -m %file} {}
  91.  
  92. This sets the temporary variable "file" to the upload directory "uldir".  The
  93. INPUt function will display the current value of "file" in the input line
  94. (with the cursor at the end).
  95.  
  96. Then DSZ will be run (direct, because of the "D" switch).  The contents of the
  97. variable "file" will be used for the filename.  After DSZ executes, the alarm
  98. will sound ("A" switch) and {COMMO} will wait for a key press ("W" switch) so
  99. you can see the results.
  100.  
  101.  
  102. A few other functions now have Function Switches to replace other parameters:
  103.  
  104.  Change                         To
  105.  ------                         --
  106.  
  107.  {dial 5,abc,c}                 {dial-C 5,abc}
  108.  {macload other.mac,abc,r}      {macload-R other.mac,abc}
  109.  {doorway s}                    {doorway-S}
  110.  
  111.  
  112. Key Changes
  113. -----------
  114.  
  115. A number of key commands now have different default keys.  These new keys may
  116. conflict with existing macros, so check them carefully.  Here is a list of the
  117. changes:
  118.  
  119.  Old key        New key         Key Command
  120.  -------        -------         -----------
  121.  
  122.   Alt-H          F1             Online Help
  123.   Alt-Q          Alt-H          Hang Up Modem
  124.   Alt-U          Alt-N          Multi Number Dial
  125.   Alt-L          Alt-P          Set Terminal Parameters
  126.   Alt-P          Alt-W          Send Password String
  127.   Alt-3          Alt-T          Master Sound toggle
  128.   Alt-4          Alt-T          AutoBaud toggle
  129.   Alt-5          Alt-T          Local Echo toggle
  130.   Alt-0          Alt-T          Signal Lights toggle
  131.  
  132.  
  133.                                 - end -
  134.